home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / jput.man < prev    next >
Encoding:
Text File  |  1992-09-16  |  7.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. jput                      User Commands                      jput
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      jput - Store files in a Jaquith archive.
  12.  
  13. SSYYNNOOPPSSIISS
  14.      jjppuutt [--aarrcchh _a_r_c_h_i_v_e] [--sseerrvveerr _h_o_s_t_n_a_m_e] [--ppoorrtt _p_o_r_t]
  15.      [--aabbss _t_e_x_t] [--aabbssffiilltteerr _p_r_o_g_r_a_m] [--aabbssffiilltteerroopptt _o_p_t_i_o_n_s]  [--
  16.      mmoodd  _m_o_d-_d_a_t_e] [--ddiirr] [--lliinnkk] [--ssyynncc] [--ffoorrccee]  [--vv] [--pprruunnee
  17.      _e_x_p_r_e_s_s_i_o_n] [--pprruunneeffuullll _e_x_p_r_e_s_s_i_o_n] [--iiggnnoorree _e_x_p_r_e_s_s_i_o_n]
  18.      [--mmaaiill _m_a_i_l_a_d_d_r] [--nneewwvvooll] [--ccrroossssrreemmoottee]  [--aacckkffrreeqq  _c_o_u_n_t]
  19.      [--llooccaall] _f_i_l_e_n_a_m_e_s
  20.  
  21. OOPPTTIIOONNSS
  22.      --aarrcchh _a_r_c_h_i_v_e Name of logical archive.  If  none  is  speci-
  23.                    fied,  the  environment  variable  JARCHIVE is
  24.                    used, if defined, else the default archive  is
  25.                    used.
  26.  
  27.      --sseerrvveerr _h_o_s_t_n_a_m_e
  28.                    Specifies host where Jaquith  server  is  run-
  29.                    ning.  Defaults  to  the  environment variable
  30.                    JSERVER.
  31.  
  32.      --ppoorrtt _p_o_r_t    Specifies port number where Jaquith server  is
  33.                    running.  Defaults to the environment variable
  34.                    JPORT.
  35.  
  36.      --mmoodd _d_a_t_e     Dump files modified since specified date.
  37.  
  38.      --aabbss _t_e_x_t     Put _t_e_x_t in the abstract line for each file.
  39.  
  40.      --aabbssffiilltteerr _p_r_o_g_r_a_m
  41.                    Invoke _p_r_o_g_r_a_m to generate abstract  for  each
  42.                    file. The utility _f_i_l_e is a good choice.
  43.  
  44.      --aabbssffiilltteerroopptt _o_p_t_i_o_n_s
  45.                    Option string to be passed to  _a_b_s_f_i_l_t_e_r  pro-
  46.                    gram.  Must  be  enclosed in quotes if it con-
  47.                    tains spaces. ie. "-a -l".
  48.  
  49.      --lliinnkk         Follow symbolic links. By default, the link is
  50.                    saved, not the file it points to.
  51.  
  52.      --ssyynncc         Write data  synchronously  to  tape.  Normally
  53.                    data  is  buffered  on disk. There is a severe
  54.                    performance penalty with this option.
  55.  
  56.      --ffoorrccee        Force files to be archived, even if an  up-to-
  57.                    date copy already exists on the archive.
  58.  
  59.      --vv            Verbose  mode.  Show  filenames  as  they  are
  60.  
  61.  
  62.  
  63. Sprite v1.0                                                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. jput                      User Commands                      jput
  71.  
  72.  
  73.  
  74.                    processed.
  75.  
  76.      --ddiirr          Put the directory and top level contents only.
  77.                    By default jput is recursive.
  78.  
  79.      --mmaaiill _m_a_i_l_a_d_d_r
  80.                    Send response by mail to _m_a_i_l_a_d_d_r when  opera-
  81.                    tion is complete.
  82.  
  83.      --nneewwvvooll       Force data  onto  a  new  volume.   The  -sync
  84.                    option is also required.
  85.  
  86.      --pprruunnee _e_x_p_r_e_s_s_i_o_n
  87.                    Subtrees with simple names  matching  globbing
  88.                    expression  _e_x_p_r_e_s_s_i_o_n  will  not be archived,
  89.                    but their  names  will  still  appear  in  the
  90.                    parent directory list. Default is NULL expres-
  91.                    sion.
  92.  
  93.      --pprruunneeffuullll _e_x_p_r_e_s_s_i_o_n
  94.                    Subtrees with  absolute  path  names  matching
  95.                    globbing  expression  _e_x_p_r_e_s_s_i_o_n  will  not be
  96.                    archived, but their names will still appear in
  97.                    the  parent  directory  list.  Default is NULL
  98.                    expression.
  99.  
  100.      --iiggnnoorree _e_x_p_r_e_s_s_i_o_n
  101.                    Files  with  simple  names  matching  globbing
  102.                    expression _e_x_p_r_e_s_s_i_o_n will not be archived and
  103.                    their names will not be listed in  the  parent
  104.                    directory.  Default is '{#*#,*~}'.
  105.  
  106.      --ccrroossss        Sprite only: Enable crossing of remote  links.
  107.                    By  default  jput  stays within the filesystem
  108.                    containing the files on the command line.
  109.  
  110.      --aacckkffrreeqq _c_o_u_n_t
  111.                    Server should acknowledge every _c_o_u_n_t file.
  112.  
  113.      --llooccaall        Sprite only: The files are local to the server
  114.                    so  don't  send the data over the net. This is
  115.                    strictly a Sprite performance hack  for  large
  116.                    backups. Invoker must be login id 'root'.
  117. _________________________________________________________________
  118.  
  119. DDEESSCCRRIIPPTTIIOONN
  120.      JJppuutt stores a directory subtree onto an archive system  con-
  121.      trolled  by  the  Jaquith server.  The filenames which match
  122.      _f_i_l_e_n_a_m_e_s are stored on the archive if they have been  modi-
  123.      fied  since  the  last  time  they  were archived, or if the
  124.      --ffoorrccee option is used.
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0                                                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. jput                      User Commands                      jput
  137.  
  138.  
  139.  
  140.      The argument _f_i_l_e_p_a_t_h is interpreted as it would  be  for  a
  141.      standard ls command, i.e., it is interpreted relative to the
  142.      current working directory, unless it begins with '/'.
  143.  
  144.      A plain file is considered to be modified if the last modif-
  145.      ication  time/date  as  reported by ssttaatt is more recent than
  146.      the date/time the file was archived, or if  the  permissions
  147.      have  changed.   A  directory  is considered modified if the
  148.      list of files in it has changed since it was last  archived,
  149.      or if the permissions have changed.
  150.  
  151.      The list of  filenames  is  filtered  (using  Unix  globbing
  152.      rules,  but  see  BUGS below) by the --pprruunnee, --pprruunneeffuullll, and
  153.      --iiggnnoorree expressions. Any filename which matches any of these
  154.      expressions  is  silently  skipped.  The options are similar
  155.      except that pruned filenames will  appear  in  their  parent
  156.      directory's list whereas ignored files will not.
  157.  
  158.      _d_a_t_e is of the form _D_a_t_e_S_p_e_c[:_T_i_m_e_S_p_e_c]. _T_i_m_e_S_p_e_c is of  the
  159.      form   [hh[:mm[:ss]]],   and   _D_a_t_e_S_p_e_c   is   of  the  form
  160.      dd-month[-yyyy]. Month is the first 3 letters of the  month;
  161.      all  others  are  numbers. The '/' character is a substitute
  162.      for '-' and '.' may be used instead of ':'.
  163.  
  164. BBUUGGSS
  165.      Files are stored and indexed by their  current  pathname  so
  166.      there is no way to store file _f_o_o as _b_a_r.
  167.  
  168.      There is currently no support for hard links.
  169.  
  170.      Unlike the shell, the Jaquith globbing  characters  '*'  and
  171.      '?' match a '.' in the first position.
  172.  
  173.      An abstract must be less than 16 kilobytes long.
  174.  
  175.  
  176. SSEEEE AALLSSOO
  177.      jaquith jmgr jls jstat jget jctrl jcopy jclean jbuild
  178.  
  179.  
  180. KKEEYYWWOORRDDSS
  181.      jaquith archive
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sprite v1.0                                                     3
  196.  
  197.  
  198.  
  199.